home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 4 / ros400_2.zip / ROSSYS.DOC < prev    next >
Text File  |  1990-12-16  |  69KB  |  1,700 lines
  1.                        System Operator's Guide to ROS
  2.  
  3.  
  4.                         Copyright (c) 1990 Steven Fox
  5.                             All Rights Reserved
  6.  
  7.  
  8.  
  9.                       Associated Information Services
  10.                                P.O. Box 13711
  11.                         Albuquerque, NM  87192-3711
  12.                                     USA
  13.  
  14.  
  15. TABLE OF CONTENTS
  16.  
  17.  
  18. INTRODUCTION..................................................  1
  19.  
  20. DISTRIBUTION..................................................  3
  21.      Shareware................................................  3
  22.      Included Files...........................................  4
  23.  
  24. SECURITY......................................................  5
  25.  
  26. INSTALLATION..................................................  7
  27.      Configuring DOS..........................................  7
  28.      Preliminary Startup......................................  7
  29.      Editing the Display Files................................  7
  30.      Connecting the Modem.....................................  7
  31.      The Setup Program........................................  9
  32.      Building a New File Catalog.............................. 10
  33.      Upgrading from ROS 3.8x.................................. 12
  34.  
  35. OPERATION..................................................... 13
  36.      Logging in the first time................................ 13
  37.      Status line.............................................. 13
  38.      Local console commands while idling...................... 14
  39.      Local console commands during remote operation........... 15
  40.      Using ROS on a Network................................... 16
  41.      Command Line Options..................................... 16
  42.  
  43. MAINTENANCE................................................... 19
  44.      Sysop Menu............................................... 19
  45.      Command Enhancements..................................... 27
  46.  
  47. EXTENDED DISPLAY CODES........................................ 29
  48.  
  49. WARNING AND ERROR MESSAGES.................................... 33
  50.  
  51. TECHNICAL SUPPORT............................................. 37
  52.  
  53. INDEX......................................................... 39
  54.  
  55.  
  56.  
  57.  
  58. INTRODUCTION
  59.  
  60. ROS is a fast, multi-user Bulletin Board System designed to operate on an
  61. IBM PC, or very compatible computer, with at least 512 k-bytes of memory.
  62. DOS version 3.0 or later is required.  To maximize the flexibility the sysop
  63. has to install new capabilities as they are developed, ROS uses a FOSSIL
  64. driver to handle the serial port, external file transfer programs to
  65. exchange files with the remote user, and external programs to display
  66. directories and text from archives.  In addition, ROS allows other external
  67. programs to be installed and accessible to the user through "doors."
  68.  
  69. Users of ROS must accept this disclaimer of warranty: 
  70.  
  71.      ROS is supplied as is.  The author disclaims all warranties, expressed
  72.      or implied, including, without limitation, the warranties of
  73.      merchantability and of fitness for any purpose.  The author assumes no
  74.      liability for damages, direct or consequential, which may result from
  75.      the use of ROS.
  76.  
  77.  
  78.  
  79. DISTRIBUTION
  80.  
  81. Shareware
  82.  
  83. Shareware distribution gives users a chance to try software before buying
  84. it.  If you try a Shareware program and continue using it, you are expected
  85. to register.  Individual programs differ on details -- some request
  86. registration while others require it, some specify a maximum trial period.
  87. With registration, you get anything from the simple right to continue using
  88. the software to an updated program with printed manual.
  89.  
  90. Copyright laws apply to both Shareware and commercial software, and the
  91. copyright holder retains all rights, with a few specific exceptions as
  92. stated below.  Shareware authors are accomplished programmers, just like
  93. commercial authors, and the programs are of comparable quality (in both
  94. cases, there are good programs and bad ones!).  The main difference is in
  95. the method of distribution.  The author specifically grants the right to
  96. copy and distribute the software, either to all and sundry or to a specific
  97. group.  For example, some authors require written permission before a
  98. commercial disk vendor may copy their Shareware.
  99.  
  100. Shareware is a distribution method, not a type of software.  You should find
  101. software that suits your needs and pocketbook, whether it's commercial or
  102. Shareware.  The Shareware system makes fitting your needs easier, because
  103. you can try before you buy.  And because the overhead is low, prices are low
  104. also. Shareware has the ultimate money-back guarantee -- if you don't use
  105. the product, you don't pay for it.
  106.  
  107. This program is produced by a                  ┌─────────┐
  108. member of the Association of             ┌─────┴───┐     │              (tm)
  109. Shareware Professionals (ASP). The     ──│         │o    │──────────────────
  110. ASP wants to make sure that the          │   ┌─────┴╨──┐ │  Association of
  111. shareware principle works for you.       │   │         │─┘  Shareware
  112. If you are unable to resolve a           └───│    o    │    Professionals
  113. shareware-related problem with an      ──────│    ║    │────────────────────
  114. ASP member by contacting the member          └────╨────┘    MEMBER
  115. directly, the ASP may be able to
  116. help. The ASP Ombudsman can help you resolve a dispute or problem with an
  117. ASP member, but does not provide technical support for members' products.
  118. Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or
  119. send a Compuserve message via easyplex to ASP Ombudsman 70007,3536.
  120.  
  121. As Shareware, ROS is provided at no charge to you for evaluation.  Feel free
  122. to share it with your friends, but please do not give it away altered or as
  123. part of another system.  The essence of "user- supported" software is to
  124. provide personal computer users with quality software without high prices,
  125. and yet to provide incentive for programmers to continue to develop new
  126. products.  If you find this program useful and find that you are using ROS
  127. and continue to use ROS after a reasonable trial period, you must make the
  128. registration payment to Associated Information Services.  The registration
  129. fee will license one copy for use on any one computer at any one time.  You
  130. must treat this software just like a book.  An example is that this software
  131. may be used by any number of people and may be freely moved from one
  132. computer location to another, so long as there is no possibility of it being
  133. used at one location while it's being used at another.  Just as a book
  134. cannot be read by two different persons at the same time.
  135.  
  136. Commercial users of ROS must register and pay for their copies of ROS within
  137. 30 days of first use or their license is withdrawn.  Site-License
  138. arrangements may be made by contacting Associated Information Services.
  139.  
  140. Anyone distributing ROS for any kind of remuneration must first contact
  141. Associated Information Services for authorization.  This authorization will
  142. be automatically granted to distributors recognized by the ASP as adhering
  143. to its guidelines for shareware distributors, and such distributors may
  144. begin offering ROS immediately.  Associated Information Services must still
  145. be advised so that the distributor can be kept up-to-date with the latest
  146. version of ROS.
  147.  
  148. You are encouraged to pass a copy of ROS along to your friends for
  149. evaluation.  Please encourage them to register their copy if they find that
  150. they can use it.  All registered users will receive a copy of the latest
  151. version of ROS.
  152.  
  153. Included Files
  154.  
  155. The following files are included with this version of ROS:
  156.  
  157.  
  158.      !READ.ME       If present, describes last minute changes and updates to
  159.                     documentation
  160.      CAT-NORM.EXE   Catalog "normalizer"
  161.      DISPLAY.ZIP    Sample menus and text display files
  162.      RESPONSE.FRM   Please tell us what you think of ROS
  163.      ROS.EXE        Main executable code for ROS
  164.      ROS-MAC.DAT    Sample macro file
  165.      ROS38-40.EXE   File conversion utility
  166.      ROSSETUP.EXE   Setup program
  167.      ROSSYS.DOC     System Operator's Guide (this file)
  168.      ROSUSER.DB     Paradox database format for the user file
  169.      ROSUSER.DBF    dBaseIV database format for the user file
  170.      ROSUSR.DOC     User's Guide
  171.  
  172.  
  173.  
  174. SECURITY
  175.  
  176. The security of a computer system is of paramount importance when that
  177. system is readily available through the telephone system.  To make ROS
  178. robust enough to withstand both incorrect entries and malicious attacks, a
  179. simple but effective method is used: an access level, ranging from 0 to 255,
  180. is assigned to each user. System privileges are based upon this number.  In
  181. general, the higher the number, the greater the privileges the user has.
  182.  
  183. The following access levels are recommended (use ROSSETUP to change):
  184.  
  185.      0-9       Twit - will be logged off immediately
  186.      10-19     Unvalidated user - limited message and files access
  187.      11        Registered user - has not yet been validated
  188.      20-249    Normal user - full message and files access
  189.      250-254   Alternate sysops
  190.      255       Primary sysop
  191.  
  192. This access level structure allows sysops to review and edit all user
  193. records in the system, including their own, but no one may change or even
  194. display the record of a user with a higher access level.
  195.  
  196.      CAUTION:  Take care not to accidentally lower your own access level.
  197.  
  198. ROS encrypts passwords to increase security.  This encryption uses a
  199. "one-way" algorithm that has no simple inverse, i.e. the encrypted password
  200. cannot be readily converted into the un-encrypted password. Nonetheless, the
  201. author recommends that the ROS-USER.DAT file and all passwords be carefully
  202. protected.
  203.  
  204.  
  205.  
  206. INSTALLATION
  207.  
  208. ROS works well with monochrome or color displays and will use direct screen
  209. writes whenever possible to improve performance.  ROS recognizes most
  210. multi-tasking executives such as DESQview and will either write to the
  211. screen buffer or, if necessary, use BIOS calls.
  212.  
  213. Configuring DOS
  214.  
  215. ROS needs 25 file handles when running.  Since DOS provides only 20 unless
  216. told otherwise, you should include the statement "FILES=25" in your
  217. CONFIG.SYS file.  This will allow ROS to open all the files it needs to
  218. operate.  If you already have a "FILES" statement with a value greater than
  219. 25, you do not need to change it.  Please refer to your DOS manual for more
  220. information about the CONFIG.SYS file and remember that after making changes
  221. to CONFIG.SYS, DOS must be rebooted.
  222.  
  223. ROS uses a FOSSIL driver for its interrupt driven interface to the
  224. communication port.  This driver is a memory resident utility that needs to
  225. be run only once after the computer is booted, regardless of how many times
  226. ROS is run.  The simplest approach is to include the FOSSIL driver in your
  227. CONFIG.SYS or AUTOEXEC.BAT.
  228.  
  229. If you plan to run ROS under a multi-tasking executive such as DESQview,
  230. then SHARE.EXE must be loaded.  Again, the simplest way to ensure SHARE.EXE
  231. is always loaded is to install it using your CONFIG.SYS or AUTOEXEC.BAT.
  232.  
  233. Preliminary Startup
  234.  
  235. ROS should be installed in its own subdirectory, e.g. "C:\ROS".  Once this
  236. directory has been created, copy all the files (see section 3) to this
  237. directory.  Then type the following command:
  238.  
  239.      ROS /D
  240.  
  241. This will run ROS in the "direct" or "no modem" mode.  If this is a new
  242. installation, ROS will create a couple of sub-directories and then
  243. automatically run the setup program.
  244.  
  245. Editing the Display Files
  246.  
  247. Before putting ROS online for the users, the text display files contained in
  248. DISPLAY.ZIP and extracted to the subdirectory ROS-SYSM should be edited.
  249. Most of these files contain embedded descriptions of how the file is to be
  250. used -- information you probably do not want to display to your users.  In
  251. addition, you will probably want to create color images of many of these
  252. files for use by your users with ANSI enabled.
  253.  
  254. Connecting the Modem
  255.  
  256. The ROSSETUP program has several commonly available modems already
  257. configured for ROS.  Simply select the modem that matches your setup or, if
  258. you have a different modem, select the one that most closely matches and
  259. then use the following paragraphs as a guideline for "Customizing" the
  260. settings. The single most common problem sysops have had with setting up a
  261. new ROS installation has been with the modem, for example: "my computer
  262. works fine with Procomm, but hangs when I run ROS."  Since the rest of the
  263. system hardware (disks, memory, etc.) is compatible at the DOS level, ROS
  264. can count on what will be available.  But, since DOS does not support
  265. interrupt driven communication port input- output (I/O), ROS has to bypass
  266. DOS and even the BIOS, to get to the modem.
  267.  
  268. In addition, "compatible" modems almost never are.  Even models made by the
  269. same manufacturer may respond differently to commands.  Sometimes these
  270. differences are significant, such as "NO DIAL TONE" instead of "DIAL TONE."
  271. More often the differences are subtle, such as whether or not the modem
  272. returns a CR/LF before and after verbal responses.  One modem does on some
  273. responses and not on others.  Another modem even changes baud rate while it
  274. is sending the connect response to the computer!  ROS is designed to be
  275. robust in the way it handles the modem and "hooks" are provided to be able
  276. to get to almost everything the modem and ROS need.
  277.  
  278. Nonetheless, experimentation may be required to get a new modem operational.
  279. Start with the simplest command string that works and add to it if
  280. necessary.  Usually, the initialization string will require the most work.
  281.  
  282. Most terminal emulation programs use open-loop control, i.e. they assume
  283. that the modem understood the command it was sent, although they do monitor
  284. the modem for some command responses, such as "BUSY" or "CONNECT."
  285.  
  286. ROS on the other hand, is expected to operate for long periods of time
  287. without attention, and thus drives the modem in closed-loop mode, i.e. all
  288. characters sent to the modem are expected to be echoed by the modem back to
  289. the computer.  Then, ROS waits for the modem to respond to the command with
  290. a result code.  For example, when ROS commands the modem to go off-hook
  291. (answer an incoming call), the modem should eventually tell ROS at what baud
  292. rate the connection was made or that the connection failed.
  293.  
  294. When attaching a modem to ROS, then, be sure that the modem is set to allow
  295. "modem echo" and "result code display."  In addition, set the modem to use
  296. "verbal (word) messages" since this matches the setup that is included with
  297. ROS.  You may, of course, modify this configuration and then set the modem
  298. to return "numeric result codes."
  299.  
  300. The only exception to the need for a character by character echo is during
  301. the modem reset string.  Some modems do not have a switch for "modem echo"
  302. and must be set into this mode through a command. If the modem requires a
  303. time delay after it is reset until it will accept another command, use
  304. pauses as necessary.  ROS interprets a tilde character ("~") as a one-half
  305. second pause.  For example, to reset a modem, wait for two seconds, and set
  306. the echo mode, the following reset string could be used:
  307.  
  308.      ATZ^M~~~~ATE1^M
  309.  
  310. Two other common switch settings should be considered.  The RS-232C Data
  311. Carrier Detect (DCD) is used by ROS to determine whether or not a connection
  312. is still valid.  In other words, ROS monitors DCD and will terminate a
  313. session if it determines that DCD has been lost.  Most modems have a switch
  314. setting that allows the modem to control DCD, based on the condition of the
  315. connection, or to force DCD always on.  The modem should be set to control
  316. DCD.
  317.  
  318. Another switch determines in what way the modem will respond to Data
  319. Terminal Ready (DTR).  This signal, coming from the computer and controlled
  320. by ROS, may be used to enable or disable the modem. For example, when a user
  321. completes a session and ROS tries to hang-up the modem, it first drops DTR.
  322. If the modem is set to disconnect when DTR is dropped, ROS will immediately
  323. see the loss of DCD and will recycle between callers very quickly.  If after
  324. a few seconds, DCD is still present, ROS will send the local mode escape
  325. sequence and then the hang-up sequence to disconnect the caller.  These
  326. steps take a little longer than simply dropping DTR.
  327.  
  328. Some modems control DTR response through commands.  These commands may be
  329. included in the reset or initialization strings sent to the modem instead
  330. of, or in addition to, the switch settings.
  331.  
  332. Finally, some modems can be set to automatically answer the phone when a
  333. ring is detected.  This function should be disabled since ROS will tell the
  334. modem when to answer the phone.  In fact, ROS expects the modem to never
  335. answer the phone unless told to do so.  One reason for doing this is to
  336. ensure the modem will not answer the phone until (and unless) the computer
  337. is ready for it to do so.  For example, if for some reason the computer
  338. "dies," long distance callers will not be charged for a call to a down
  339. system.
  340.  
  341. To monitor the modem commands and responses, append "/M" to the command line
  342. when starting ROS. When you are satisfied that ROS and the modem are
  343. communicating properly, just start ROS without the "/M" to improve the local
  344. display appearance.
  345.  
  346. In modem command strings, a "^M" is used to send a carriage return to the
  347. modem.  A tilde ("~") causes a delay for 1/2 second before continuing.  For
  348. example, "~~~+++" delays for 1 1/2 seconds, and then sends "+++" to the
  349. modem.  Command strings may be up to 50 characters long (although most
  350. modems only allow 40 characters not including the prefix "AT," spaces, or
  351. the carriage return); responses may be as long as 16 characters.
  352.  
  353. The following modem initialization string works well with most Hayes
  354. compatible modems:
  355.  
  356.      |get the modem's attention
  357.      |  |the modem should echo characters when off-line
  358.      |  |  |ensure the phone is hung up
  359.      |  |  |  |return result codes
  360.      |  |  |  |  |disable auto answer
  361.      |  |  |  |  |    |wait 30 seconds for carrier
  362.      |  |  |  |  |    |     |verbose (word) result codes
  363.      |  |  |  |  |    |     |  |enable extended command set
  364.      |  |  |  |  |    |     |  |  |turn off the speaker
  365.      |  |  |  |  |    |     |  |  |  |command terminator
  366.      AT E1 H0 Q0 S0=0 S7=30 V1 X4 M0 ^M
  367.  
  368.      Sample Modem Initialization Command String
  369.  
  370.  
  371. The Setup Program
  372.  
  373. ROSSETUP is the program used to setup message and file areas, doors, modems,
  374. and most other configurable resources used by ROS.  Since the program is
  375. menu driven with help messages throughout, these instructions will be
  376. succinct.
  377.  
  378.      The Command Line
  379.  
  380. The command line used by ROSSETUP is similar to that used by ROS itself.
  381. Please refer to the Command Line section for details.
  382.  
  383.      The Line Editor
  384.  
  385. Many of the entries to be made in ROSSETUP require more than one character
  386. to be entered, e.g. the full sub-directory specification for a door.  The
  387. following commands are available for editing:
  388.  
  389.      <Left>, <CtrlS>      Move cursor left one character
  390.      <Right>, <CtrlD>     Move cursor right one character
  391.      <CtrlLeft>, <CtrlA>  Move cursor left one word
  392.      <CtrlRight>, <CtrlF> Move cursor right one word
  393.      <Home>, <CtrlQ><S>   Move cursor to beginning of line
  394.      <End>, <CtrlQ><D>    Move cursor to end of line
  395.      <Del>, <CtrlG>       Delete character at cursor
  396.      <Bksp>, <CtrlH>      Delete character to left of cursor
  397.      <CtrlY>              Clear entire field or line
  398.      <CtrlEnd>, <CtrlQ><Y>
  399.                           Delete to end of field or end of line
  400.      <CtrlHome>           Delete from beginning of field to cursor
  401.      <CtrlT>              Delete word to right of cursor
  402.      <CtrlP>              Insert literal, e.g. <CtrlP><CtrlM> inserts a <CtrlM>
  403.                           (Carriage return) in the text
  404.      <Ins>, <CtrlV>       Toggle insert mode on and off
  405.      <Enter>, <CtrlM>, <ClickCenter>
  406.                           Accept contents of field
  407.      <CtrlEnter>, <CtrlJ> Accept contents of field and record
  408.      <CtrlR>, <CtrlQ><L>  Restore original contents of line
  409.      <Esc>, <CtrlBreak>, <ClickRight>
  410.                           Quit editing
  411.  
  412.      Menus
  413.  
  414. The following menu will be displayed when ROSSETUP is first started.  As
  415. each entry is selected by pressing the <Enter> key, additional menus will be
  416. displayed.  When all changes have been made, select "Exit."
  417.  
  418.      ┌────────────────────────────────────────────────────────────────┐
  419.      │  System  User  Comm  Modem  Retention  Access  Control   Exit  │
  420.      └────────────────────────────────────────────────────────────────┘
  421.  
  422. Building a New File Catalog
  423.  
  424. Using the tools provided with ROS, building a new file catalog is not at all
  425. difficult.  Six steps are required:
  426.  
  427.      1.   Collect file descriptions from other sources, such as other
  428.           bulletin boards willing to share.
  429.      2.   Use CAT-NORM to "normalize" these catalogs.
  430.      3.   Edit the normalized description file (CAT-NORM.OUT) as required.
  431.      4.   Use the <S>ysop <C>atalog <R>econcile command to create the
  432.           basic catalog.
  433.      5.   Use the <S>ysop <C>atalog <D>escribe command to incorporate
  434.           the descriptions built in steps 1 through 3.
  435.      6.   Use the <S>ysop <C>atalog <B>uild command to build the new
  436.           CATALOG file for users to download.
  437.  
  438.      Using CAT-NORM
  439.  
  440. Syntax: CAT-NORM [d:][path]filename[.ext] [n] [e]
  441.  
  442. [d:][path]filename[.ext] specifies the input file(s) to be processed.  If
  443. the input drive or path are not specified, the current default directory
  444. will be assumed.  Wildcards are allowed, e.g. "*.CAT".
  445.  
  446. [n] specifies the starting column of the description in the input file(s).
  447. If this value is less than 13 or not specified, CAT-NORM will assume column
  448. 13.
  449.  
  450. [e] specifies the number of catalog entries to be sorted. If not included, a
  451. value of 30,000 will be assumed.  This value should be large enough to
  452. accomodate the number of elements to be sorted, but not so large as to cause
  453. the sort to fail for lack of resources.
  454.  
  455. Examples:
  456.  
  457.      CAT-NORM *.DIR 34
  458. This processes all files with an extent of "DIR".  The descriptions in these
  459. files will be found starting in column 34.
  460.  
  461.      CAT-NORM C:\LOGIN\CATALOG
  462. This processes the file "CATALOG" in the "LOGIN" subdirectory  of drive "C".
  463. The descriptions will be found in column 13.
  464.  
  465.      Limitations
  466.  
  467. The number of entries that can be processed is limited to about 2 billion.
  468. Practically, the real limit will be the disk space available for the sort
  469. phase.
  470.  
  471.  
  472.      Output File
  473.  
  474. The file CAT-NORM.OUT will be created.  If no lines are output to this file,
  475. it will be empty.  If it already exists, all data in the old file will be
  476. lost.
  477.  
  478.      Operations Performed
  479.  
  480. The following operations are performed to normalize input files:
  481.  
  482.      Tabs are expanded into spaces
  483.      File names are normalized thus:
  484.           file name and file extent are separated by "."
  485.           embedded blanks are removed
  486.           all characters are forced to upper case
  487.      Entries with file names containing invalid characters are removed
  488.      Leading and trailing blanks are trimmed from the description
  489.      Entries with empty descriptions are removed
  490.      The entries are sorted in ascending order by file name and description
  491.      Duplicate entries are removed
  492.  
  493. As a result, ROS can handle catalogs with file names in the format
  494. "NAME    EXT" as well as the more conventional "NAME.EXT".  Since duplicate
  495. entries will be removed, it is possible to merge catalogs from many sources
  496. without getting an output file that is too large to work with.  ANY
  497. difference in two entries will cause both entries to be included, including
  498. differences in case.  Since entries with filenames containing invalid
  499. characters (as defined by DOS) are removed, headers such as the following
  500. will not be included in the output file and do not have to be manually
  501. removed:
  502.  
  503.      +-------------------------------------------------------+
  504.      | ACCOUNTING     Bookkeeping, taxes, inventory, etc.    |
  505.      +-------------------------------------------------------+
  506.  
  507. Upgrading from ROS 3.8x
  508.  
  509.      CAUTION: A backup of your current ROS 3.8x database should be made
  510.      before performing the procedure described in this section.
  511.  
  512. The ROS file update utility, ROS38-40.EXE, converts version 3.8x data files
  513. into the format expected by version 4.0.  To use this program, copy it into
  514. the subdirectory containing your version 3.8x files and enter the following
  515. command:
  516.  
  517.      ROS38-40
  518.  
  519. After verifying the program will be run on version 3.8x files, all
  520. operations are automatic and require no additional inputs.  The program may
  521. take several minutes to complete its conversions, depending on the size of
  522. the existing database.
  523.  
  524.      NOTE: ROS38-40.EXE will only operate correctly on version 3.8x files.
  525.      Attempts to run the program using files from other versions of ROS will
  526.      produce unpredictable results.
  527.  
  528.  
  529.  
  530. OPERATION
  531.  
  532. ROS maintains its support files in the sub-directory in which it starts.
  533. You can protect access to these files by not including this area in your
  534. setup or - if you need remote access - ensuring the access level of this
  535. area is set sufficiently high (250-255).
  536.  
  537. Logging in the first time
  538.  
  539. When you run ROS the first time, it will create the files it needs.  ROS
  540. will signon and let you know what files it is making and then get the modem
  541. ready.  When the status line appears, ROS is in an idling state and is ready
  542. for one of four actions:
  543.  
  544.      1.  a signal from the modem indicating an incoming call, or
  545.      2.  a time initiated macro to start, or
  546.      3.  a command from the console to shutdown, or
  547.      4.  a command from the console indicating a local user.
  548.  
  549. To log in locally, press the <Enter> key.  After the "Name>" prompt appears,
  550. enter "SYSOP" as your full name and press <Enter>.  This is a special name
  551. that ROS recognizes.  Since this is the first time you have been on the
  552. system, ROS will prompt for a password - enter one of your choice.  You are
  553. now logged into the system.  As the sysop, you are automatically assigned an
  554. access level of 255.
  555.  
  556.      CAUTION: It is very important that you login as "sysop" and set your
  557.      password before making the system available for others to use,
  558.      otherwise they may get sysop privileges on your system!
  559.  
  560. Status line
  561.  
  562. A single line of information will be displayed on the bottom line of the
  563. local console screen at all times, even when the display is blanked.  Two
  564. formats are used, one while ROS is waiting for a call and another when a
  565. user is actually logged into the system.
  566.  
  567.      When waiting for a call
  568.  
  569. When ROS is waiting for a call, a status line with the following information
  570. will be displayed:
  571.  
  572.      Node | Memory | Time
  573.  
  574. where
  575.  
  576.      Node      the node number
  577.      Memory    the amount of working memory available to ROS (in bytes)
  578.      Time      the current time of day
  579.  
  580. If a time initiated macro has been defined, an addition field will be
  581. displayed showing the date and time when this macro will start.
  582.  
  583.      When a user is logged in
  584.  
  585. When a user is logged into ROS, a status line of the following form will be
  586. displayed:
  587.  
  588.      Node | Memory | Time | Icons | Speed | Access | Name | Phone | City, State
  589.  
  590. where
  591.  
  592.      Node         the node number
  593.      Memory       the amount of working memory available to ROS (in bytes)
  594.      Time         the time remaining to the current user
  595.      Icons        system status information:
  596.                         chat signal on
  597.                         remote online
  598.                         delayed shutdown enabled
  599.      Speed        the speed of the current remote user or the word
  600.                   "Internal" or "Local"
  601.      Access       the access level of the current user
  602.      Name         the name of the current user
  603.      Phone        the phone number of the current user
  604.      City, State  the city and state of the current user
  605.  
  606.  
  607. Local console commands while idling
  608.  
  609.      ┌───────────────────────────────────────────────┐
  610.      │F1: Help                 F2: Macro Start       │
  611.      │F3:                      F4:                   │
  612.      │F5: Toggle Chat Signal   F6:                   │
  613.      │F7:                      F8:                   │
  614.      │F9:                     F10:                   │
  615.      │Alt-X: Shutdown ROS   Enter: Local Login       │
  616.      └───────────────────────────────────────────────┘
  617.  
  618.      F1: Help
  619.  
  620. This command displays the help menu as shown above.
  621.  
  622.      F2: Macro Start
  623.  
  624. If a time initiated macro has been installed, this key will start the macro
  625. as if the timer had expired.
  626.  
  627.      F5: Toggle Chat Signal
  628.  
  629. This key will alternately disable and re-enable the chat signal.  If a user
  630. requests chat during the chat period, this key may be used to turn off the
  631. console bell.
  632.  
  633.      Alt-X: Shutdown ROS
  634.  
  635. This key will shutdown the system and return to the DOS prompt.
  636.  
  637.      Enter: Local Login
  638.  
  639. Pressing the <Enter> key will take the modem off hook and allow you to
  640. proceed as if you were a remote caller.  All operations except file transfer
  641. are available.
  642.  
  643. Local console commands during remote operation
  644.  
  645. The local console has several commands that may be used while the system is
  646. connected to a remote user:
  647.                
  648.      ┌───────────────────────────────────────────────┐
  649.      │F1: Help                 F2:                   │
  650.      │F3:                      F4:                   │
  651.      │F5: Toggle Chat Signal   F6: Chat              │
  652.      │F7: Toggle Remote        F8: Validate User     │
  653.      │F9:                     F10:                   │
  654.      │ : 5 Minute Increment    : 5 Minute Decrement│
  655.      │  ^End: Immediately Logoff Current User        │
  656.      │ Alt-X: Shutdown ROS after Current User        │
  657.      │Alt-Fn: List ALTFn File                        │
  658.      └───────────────────────────────────────────────┘
  659.  
  660.      F1: Help
  661.  
  662. This command displays the help menu as shown above.
  663.  
  664.      F5: Toggle Chat Signal
  665.  
  666. This key will alternately disable and re-enable the chat signal.  If a user
  667. requests chat during the chat period, this key may be used to turn off the
  668. console bell.
  669.  
  670.      F6: Chat
  671.  
  672. This key may be used by the sysop to initiate a chat or to answer a chat
  673. request from the user.
  674.  
  675.      F7: Toggle Remote
  676.  
  677. This command alternately disables and re-enables the output to the remote
  678. system.  Disabling the remote I/O is useful since local operations can
  679. proceed at full speed without waiting for the relatively slow modem.
  680.  
  681.      F8: Validate User
  682.  
  683. This command may be used to validate a user while they are logged in.  It is
  684. equivalent to using the Sysop <V>alidate command.
  685.  
  686.  
  687.      : 5 Minute Increment
  688.  
  689. This command will add five minutes to the user's time for the current
  690. session.
  691.  
  692.      : 5 Minute Decrement
  693.  
  694. This command will subtract five minutes from the user's time for the current
  695. session.
  696.  
  697.      ^End: Immediately Logoff Current User
  698.  
  699. This command will immediately disconnect the current user.  No reason will
  700. be given.
  701.  
  702.      Alt-X: Shutdown ROS after Current User
  703.  
  704. This command will cause ROS to shutdown after the current user logs out.
  705.  
  706.      Alt-Fn: List ALTFn File
  707.  
  708. When any function key is pressed while the <Alt> key is held down, ROS will
  709. immediately display the contents of the associated ALTFn.xxx file.  "n" is a
  710. number from 1 to 10 indicating the function key and "xxx" is either "ASC" or
  711. "ANS" depending on the operating mode of the current user.
  712.  
  713. Using ROS on a Network
  714.  
  715. ROS explicitly recognizes the following networks (other networks which
  716. emulate one or more of these may be compatible):
  717.  
  718.      1.  Novell's NetWare (ELS, Advanced, SFT)
  719.      2.  MS-Net or compatible (SHARE must be loaded)
  720.      3.  MS-Net compatible with NetBIOS machine name support
  721.      4.  CBIS' Network-OS
  722.      5.  Software Link's PC-MOS 386
  723.      6.  Banyan's Vines
  724.      7.  Alloy's NTNX
  725.  
  726. In addition, ROS works well on a non-networked, single-user system.
  727.  
  728. To specify the network, use the command line parameter "/Tx" where "x" is a
  729. number from "1" to "7" as shown in the above list.  If this parameter is not
  730. included or if an invalid number is entered, ROS will assume no network is
  731. being used.  When operating on a network, the parameter "/Ny" - where "y" is
  732. a number from "1" to "9" to specify the node - must be included.  This
  733. number must be unique for each node.  For example, to run ROS on a NetWare
  734. system, use a command line similar to the following:
  735.  
  736.      ROS /T1 /N3
  737.  
  738. When using ROS on a Novell NetWare system, NetWare specific calls to mark
  739. files as shareable are used; this service returns an error when the file is
  740. not on a server drive.  This means that on a NetWare system, your files MUST
  741. reside on a net drive and cannot be located on a local drive.
  742.  
  743. ROS is "DESQview aware" and, in addition to confining its video output to
  744. its own portion of the screen, will relinquish any unneeded time to tasks
  745. running in other windows.  A DESQview window of approximately 440 k-bytes of
  746. memory is required.
  747.  
  748. Command Line Options
  749.  
  750. Several command line options are recognized by ROS:
  751.  
  752.      /d   direct connect - ignore modem responses
  753.      /i   information on FOSSIL driver should be displayed locally
  754.      /m   modem information display
  755.      /n   node number
  756.      /r   reorganize user and catalog files
  757.      /t   type of network
  758.  
  759. These options may be used in any order, with or without spaces separating
  760. them.
  761.  
  762.      Option /d
  763.  
  764. This option causes ROS to ignore the modem.  It is useful in two situations.
  765. First, there may be situations when you do not have a modem connected to the
  766. serial port or the modem is already off-hook and you do not want to hang up.
  767. Since modem commands and modem responses are inhibited with this command, it
  768. may also be used when there is no modem connected at all.  In fact, the
  769. system may be connected to another computer.
  770.  
  771.      Option /i
  772.  
  773. When this command line option is included, ROS will display additional
  774. information about the FOSSIL driver when it starts and as the FOSSIL driver
  775. is opened and closed.
  776.  
  777.      Option /m
  778.  
  779. To assist in setting up your modem, the command line parameter "/m" may be
  780. used to display commands sent to the modem and responses from the modem.  A
  781. left pointing triangle ("") indicates a carriage return, and a down
  782. pointing arrow ("") indicates a line feed.
  783.  
  784.      Option /r
  785.  
  786. ROS can recover from many types of damage to the user and catalog files, and
  787. it can recover from corrupted or even missing index files (in fact, if you
  788. suspect that your index files may have become corrupted, simply delete them.
  789. ROS will rebuild them as necessary.  This includes all ROS files with the
  790. ".IX" extension.  To reorganize the user and catalog data files and
  791. subsequently rebuild the index files, you may add a "/r" to the command
  792. line.
  793.  
  794. Normally, this option is not needed, but there may be times when it can
  795. improve or even restore system operation.  For example, while ROS re-uses
  796. deleted records to keep the user and catalog databases as compact as
  797. possible, you may wish to use this option to physically remove the deleted
  798. records from the file.
  799.  
  800. One situation in which you may need to recover your data and index files
  801. should never occur, but a disk failure or other serious system problem could
  802. cause damage to the data or index files.  If you suspect that any of these
  803. files may be damaged, use this option.  ROS commits to disk all system files
  804. frequently to minimize data loss.  You can even reset or power down the
  805. computer while ROS is running without serious consequences, although this is
  806. not recommended. During execution, ROS will display counts of records
  807. processed and the supported data files on which it is working.
  808.  
  809.      Option /t
  810.  
  811. This option tells ROS what type of network is being used.  Please refer to
  812. the section titled "Using ROS on a Network" for more information.
  813.  
  814.      Option /n
  815.  
  816. This option is for network use.  Please refer to the section titles "Using
  817. ROS on a Network" for more information.
  818.  
  819.  
  820.  
  821. MAINTENANCE
  822.  
  823. As the sysop, you should regularly use ROS to read mail, validate new users,
  824. and release (or not) the new files uploaded to the system.  A check may also
  825. be made of other messages and mail to ensure that they are appropriate to
  826. the philosophy of the system.  Beware of messages and mail which contain
  827. credit card numbers, computer access codes, or other sensitive information.
  828.  
  829. Sysop Menu
  830.  
  831. The sysop command system is accessed by typing <X> at a message or file menu
  832. prompt.  This command is not available to users below the alternate sysop
  833. access level.
  834.  
  835. The following figure lists the commands available to the sysop.  This menu
  836. may be displayed at any time by entering <?>.  Subsequent sections describe
  837. each command in detail.
  838.  
  839.         Sysop Menu
  840.  
  841.         Exchange      List           Style           Viewpoint
  842.      ------------------------------------------------------------------
  843.         <C>atalog     <L>ist files   <S>etup         <D>own at logout
  844.         <U>sers       <V>ersions     <X>pert toggle  <F>iles
  845.         <K>ey macros                 <A>udit trail   <M>essages
  846.         <P>urge                                      <G>oodbye (logout)
  847.  
  848.  
  849.      <C>atalog
  850.  
  851. This command provides access to the file catalog system.  Refer to Section
  852. 13 for more information about setting up a new catalog.  The following
  853. commands, described in the following sections, are available:
  854.  
  855.    Build  Describe  Edit  Post  Reconcile  Global   Quit
  856.  
  857.           Build
  858.  
  859. This command builds two files, "CATALOG" and "LEADERS".  The first is the
  860. contents of the catalog.  The second is a list of the most frequently
  861. downloaded files.  Both files will be built into the LOGIN file area.
  862.  
  863.           Describe
  864.  
  865. Many sources are currently available for the descriptions that are to be
  866. included in your catalog.  These sources include other bulletin board
  867. systems, catalog files you may be currently maintaining by hand, and other
  868. catalog systems.  ROS provides this command to make use of these sources to
  869. speed the development of your catalog.  When this command is executed, ROS
  870. will prompt for a file name (a full path name including drive may be
  871. entered) that contains file names and descriptions in the following format:
  872.  
  873.      name.ext  description
  874.  
  875. where "name.ext" is the file name and extension of a file which may be in
  876. your catalog and "description" is the description of that file.  Up to 50
  877. characters of description are allowed.
  878.  
  879. After accepting the file name (a null name will exit this function), ROS
  880. will prompt for the column in which the description starts.  ROS will then
  881. ask whether or not it should update existing descriptions.
  882.  
  883. If the default "no" response is entered, only blank descriptions will be
  884. updated.  If ROS finds the file name in the current catalog, and its
  885. description is currently blank, the description from the specified text file
  886. will be added.  Existing descriptions will not be overwritten nor will files
  887. which are not in the catalog be added.
  888.  
  889. If you answer "yes", existing descriptions will be changed.  This option is
  890. useful if you want to edit your existing CATALOG with your favorite word
  891. processor and then feed this catalog back into ROS.  NOTE: duplicate file
  892. names in different file areas may produce unexpected results since only the
  893. first entry will be changed.  Use this option with care.
  894.  
  895. This command may even be used to restore a completely destroyed catalog if
  896. the text file "CATALOG" is still available.  Simply specify "CATALOG" for
  897. the input text file and column 29 for the column in which the description
  898. starts.
  899.  
  900. For example, call another local BBS or two and download their descriptions.
  901. These descriptions do not have to be in any special order, nor does ROS care
  902. if there are blank lines or lines with special characters.  What it is
  903. looking for is an exact match of the file name in columns 1-12 of the file.
  904. If this is found and the current catalog description is blank, the text
  905. description will be added to the catalog.
  906.  
  907.           Edit
  908.  
  909. This command allows you to display and edit catalog entries.  If the command
  910. has not been previously executed in the current session, the first record in
  911. the default file area will be displayed. Subsequent uses of this command
  912. will redisplay record displayed the last time the command was used. The
  913. following commands are available during editing:
  914.  
  915.    Area Forward Backward  Select Next Previous  Edit  Delete  Release   Quit
  916.  
  917. Area
  918.  
  919. This command is used to change the file area currently being accessed.
  920.  
  921. Forward
  922.  
  923. This command changes the current file area to the next area alphabetically.
  924. ROS will then display the first record in that file area.  File areas "wrap
  925. around," i.e. when the last file area is current, using this command will
  926. cause the first file area to become current.
  927.  
  928. Backward
  929.  
  930. This command changes the current file area to the previous area
  931. alphabetically.  ROS will then display the first record in that file area.
  932. File areas "wrap around," i.e. when the first file area is current, using
  933. this command will cause the last file area to become current.
  934.  
  935. Select
  936.  
  937. This command allows you to select a specific file to be displayed from the
  938. current file area.
  939.  
  940. Next
  941.  
  942. The next alphabetical catalog entry will be displayed.  If there are no more
  943. entries in the current file area, the next file area will be made current
  944. and the first record in that area will be displayed.
  945.  
  946. Previous
  947.  
  948. The previous alphabetical catalog entry will be displayed.  If there are no
  949. more entries in the current file area, the previous file area will be made
  950. current and the last record in that area will be displayed.
  951.  
  952. Edit
  953.  
  954. This command positions the cursor at the first field of the record, ready to
  955. edit.  As the <Enter> key is pressed, subsequent fields will be edited.  The
  956. catalog fields are as follow:
  957.  
  958.      Home area     This is the file area in which the file will spend most
  959.                    of its time.  When a file is added to the system, by an
  960.                    upload or directly, this field should be set to reflect
  961.                    the file area most appropriate to the content of the
  962.                    file.  For example, a new file, MYCB.ARC is uploaded to
  963.                    the system.  The current area (see below) will be set to
  964.                    "UPLOAD" automatically.  Upon determining the file is
  965.                    another checkbook balancing program, you may decide that
  966.                    the file belongs in the ACCOUNTING file area.  The home
  967.                    area should be set to "ACCOUNTING."  After the file has
  968.                    been in the NEWIN area for a time, it will be moved to
  969.                    the "ACCOUNTING" area when the <P>ost command is
  970.                    executed.
  971.  
  972.      Current area  This is the file area where the file can presently be
  973.                    found.  If this field is changed, the file will be
  974.                    automatically relocated to its new area.
  975.  
  976.      Name          The name of the file
  977.  
  978.      Description   The textual description of the file
  979.  
  980.      Size          The file size in bytes
  981.  
  982.      Accesses      The number of times the file has been downloaded
  983.  
  984.      Upload date   The date the file was uploaded to the system
  985.  
  986.      Uploaded by   The user that performed the upload
  987.  
  988.      Last download The date and time of the last download
  989.  
  990. Normal editing commands are available on all fields except the last two,
  991. "Uploaded by" and "Last download."  Please refer to the ROS User's Guide for
  992. more information on the editor.
  993.  
  994. Delete
  995.  
  996. This command will delete the current catalog entry and its associated file.
  997. Both actions are verified before taking place.
  998.  
  999. Release
  1000.  
  1001. This command is used to release a file into the NEWIN file area, thus making
  1002. it available to users.
  1003.  
  1004. Quit
  1005.  
  1006. This command exits the catalog entry editor.
  1007.  
  1008.           Post
  1009.  
  1010. This command automatically performs most of the housekeeping that a large
  1011. file repository, such as a BBS, needs.  For example, new versions of files
  1012. are added to the system, old versions must be purged, changes to the file
  1013. area structure may have to be made, etc.
  1014.  
  1015. The name of file and its description are entered by the user and the other
  1016. fields are set by the system when the file is uploaded.  The sysop then sets
  1017. the "Home area" and releases the file to the NEWIN area. The "Upload date"
  1018. and the "Last access" field are used to determine when a posting action
  1019. should take place.  After a file has been in the NEWIN area for "Newin"
  1020. days, it will be moved to its Home Area. After a file has been in its Home
  1021. Area for "Other" days without being accessed, it will be moved to the DUSTY
  1022. area.  This area indicates to users that after "Dusty" days without access,
  1023. the file will be removed from the system.  From DUSTY, the file is moved to
  1024. the ARCHIVE file area (which should not available to users).  Files in this
  1025. area then may be copied to a backup media such as floppy disk or tape and
  1026. then deleted.  The migration of files through the system can be displayed
  1027. thus:
  1028.  
  1029.      NEWIN --> home area --> DUSTY --> ARCHIVE --> deleted
  1030.  
  1031. ROS will not actually delete any files from the system.  This is left to the
  1032. sysop.
  1033.  
  1034. Note the difference in the way ROS determines expiration for the NEWIN area
  1035. compared to all other file areas: in NEWIN, "Upload date" is used, while
  1036. "Last access" is used elsewhere.
  1037.  
  1038.           Reconcile
  1039.  
  1040. This command is used to ensure the physical directory and the catalog
  1041. maintained by ROS are in agreement.  If a change in the file size is made,
  1042. this command will detect this change and update the catalog.  If files are
  1043. listed in the catalog, but not found in the disk directory, ROS will mark
  1044. them as missing.  If files are found in the disk directory, but not in the
  1045. catalog, ROS will add them.
  1046.  
  1047. Since pictures are such a popular item, ROS can even automatically add the
  1048. size (in pixels) of .GIF files to the file description.
  1049.  
  1050.           Global
  1051.  
  1052. This command changes the "home" and "current" area fields from one value to
  1053. another.  For example, you have decided that "TOOLS" is a better file area
  1054. name than "PROGRAMS."  After making the change in ROSSETUP, you start ROS
  1055. and enter this command to effect the change for all the catalog entries. No
  1056. files are moved, only the catalog and its associated index files are
  1057. updated.  NOTE: If the ROSSETUP is changed and the catalog entries are not,
  1058. users will not have access to the files.
  1059.  
  1060.           Quit
  1061.  
  1062. This command terminates the catalog edit session.
  1063.  
  1064.      <U>sers
  1065.  
  1066. This command allows the sysop to display and edit user records.  The first
  1067. time this command is used in a session, the first record in the user file
  1068. will be displayed.  Subsequent uses of this command will redisplay the last
  1069. record edited.  The following commands, described in subsequent sections,
  1070. are available to move around the user file:
  1071.  
  1072.   Registered  Select Next Previous  Edit Delete Insert Validate Force  Quit
  1073.  
  1074.           Registered
  1075.  
  1076. This command will search for a user that has registered for validation.  If
  1077. the displayed record does not change, there are no more registered users.
  1078.  
  1079.           Select
  1080.  
  1081. When this command is entered, ROS will prompt for a new user name and then
  1082. display that user for edit. Access level restrictions similar to those
  1083. described for the next record command apply.
  1084.  
  1085.           Next
  1086.  
  1087. When this command is entered, ROS will find the next user record
  1088. (alphabetically by last name and then first name) and display it for edit.
  1089. Only records with access levels equal or less than the user will be
  1090. displayed, e.g. alternate sysops cannot modify or even view the primary
  1091. sysop record.
  1092.  
  1093.           Previous
  1094.  
  1095. When this command is entered, ROS will find the previous user record
  1096. (alphabetically by last name and then first name) and display it for edit.
  1097. Access level restrictions similar to those described for the next record
  1098. apply.
  1099.  
  1100.           Edit
  1101.  
  1102. The cursor will be positioned at the "Name" field for editing using commands
  1103. identical to those used for messages (refer to the ROS User's Guide).  All
  1104. fields except the time of last access can be edited.
  1105.  
  1106. ROS does not require precise entry of the user name to find a record for
  1107. editing.  It will find the record which is equal to or greater than the
  1108. entered name.  For example, if you cannot remember how John Smith spells his
  1109. last name, enter "John" for the first name and "Smith" for the last name.
  1110. ROS will find the record even if John spells his last name "Smithe."  While
  1111. this is a useful feature, similar names can result in the display of a
  1112. record other than the one desired.  Ensure the desired record is actually
  1113. displayed before making changes.
  1114.  
  1115.           Delete
  1116.  
  1117. ROS will prompt to verify that this is the action desired.  If so, it will
  1118. delete the user and any messages addressed to or from that user.
  1119.  
  1120.           Insert
  1121.  
  1122. This command may be used to add a new user to the system.  ROS will verify
  1123. that the name does not already exist.  If not, it will prompt for the new
  1124. password and then display the record for further edits. This command is
  1125. especially useful for closed systems where new users are not allowed to
  1126. register on-line.
  1127.  
  1128.           Validate
  1129.  
  1130. This command changes the access level and time allowance for the user being
  1131. edited to the values defined by ROSSETUP.  It is more convenient than
  1132. editing the user and can be performed easily from a remote site.
  1133.  
  1134.           Force
  1135.  
  1136. Since passwords cannot be viewed, this command is available to enter a new
  1137. password for a user.  The new password will echo as it is typed.
  1138.  
  1139.           Quit
  1140.  
  1141. When all user records have been edited, enter this command and ROS will
  1142. return to the sysop menu.
  1143.  
  1144.      <K>ey Macros
  1145.  
  1146. In addition to being able to read characters from either the keyboard or the
  1147. remote channel, ROS can read from internal character strings called
  1148. "macros."  These strings can be used to execute any sequence of operations
  1149. as defined by the sysop.  Since some of the system maintenance commands can
  1150. take some time to complete, macros are very useful.
  1151.  
  1152. In addition to the text editing commands described in the ROS User's Guide,
  1153. pressing <B> for "Begin" will cause ROS to prompt for the macro number to
  1154. execute.  Since the macro file is a standard text file, most text editors
  1155. and word processors that can operate in a pure ASCII mode can also be used
  1156. to edit the ROS-MAC.DAT file.
  1157.  
  1158. ROS is still monitoring both the local and remote keyboards while processing
  1159. a macro so the sysop can pause (^S) or cancel (^C) a command.
  1160.  
  1161. Since a carriage return is used to terminate the entry of a new macro
  1162. string, a slash (/) may be entered into the macro.  When encountered, ROS
  1163. will convert this character into a carriage return.  As shown in the
  1164. example, control characters may be entered by prefixing a standard letter
  1165. with a carat ("^").  For example, CTRL-G may be inserted into a macro with
  1166. the two character string "^G".
  1167.  
  1168.           Time Initiated Macro
  1169.  
  1170. If the macro starts with a colon and a time of day, e.g. ":00:15", ROS will
  1171. use this time to automatically start the macro execution.  Only one time
  1172. initiated macro is allowed.
  1173.  
  1174.           Macro Example
  1175.  
  1176. The sample macro file included with ROS performs the following:
  1177.  
  1178. :4 00:01,sysop/nnnodaily1/xapaycpbqmodaily2/xcrlogin/yqagy
  1179.  
  1180.      :4        node to run the macro
  1181.      00:01,    macro start time and separator
  1182.      sysop/    user name terminated with a carriage return
  1183.      nnn       answer "no" three times to clear any questions
  1184.      o         open a door
  1185.      daily1/   name of door
  1186.      x         enter the sysop system
  1187.      a         turn on the audit trail
  1188.      p         purge...
  1189.      a         ...all files
  1190.      y         yes, really do it
  1191.      c         start the catalog processor
  1192.      p         post the files
  1193.      b         build a new text catalog and leaders list
  1194.      q         quit the catalog processor
  1195.      m         back to the messages system
  1196.      o         open another door
  1197.      daily2/   name of door
  1198.      x         back to sysop system
  1199.      c         catalog
  1200.      r         reconcile...
  1201.      login/    ...the LOGIN file area (ensures the two files we just built
  1202.                are up to date)
  1203.      n         no, don't update any .GIF files
  1204.      q         quit the catalog processor
  1205.      a         turn off the audit trail
  1206.      g         goodbye
  1207.      y         yes, really
  1208.  
  1209.  
  1210.      <P>urge
  1211.  
  1212. This command purges selected files of outdated entries.  It processes three
  1213. different files, each selectable by a single command, or all three files
  1214. together.  All commands are verified before continuing.
  1215.  
  1216.           All
  1217.  
  1218. This command purges all three files, i.e. it automatically performs a purge
  1219. of the catlalog, log, and user files.
  1220.  
  1221.           Catalog
  1222.  
  1223. This command purges the file catalog system of any entries that are
  1224. currently marked as "Missing."
  1225.  
  1226.           Log
  1227.  
  1228. This command removes entries from the log file that are more than seven days
  1229. old.
  1230.  
  1231.           Users
  1232.  
  1233. This command deletes all users that have not logged in within the times
  1234. specified in ROSSETUP.  When a user is purged with this command, any
  1235. messages sent to or from that user will also be deleted.
  1236.  
  1237.      <L>ist system files
  1238.  
  1239. When this command is entered, two secondary commands may be entered to
  1240. select which file should be listed.
  1241.  
  1242.           Log
  1243.  
  1244. ROS maintains a time and date tagged list of most system operations.  This
  1245. command will display this list.  From the information contained in this
  1246. file, you can determine what kind of activity the system is being used for,
  1247. what users seem to be having problems, what users are abusing their
  1248. privileges, etc.
  1249.  
  1250.           Messages
  1251.  
  1252. All messages after the specified date will be displayed in chronological
  1253. order.  
  1254.  
  1255.      <V>ersions
  1256.  
  1257. This command displays the version numbers of DOS, DESQview (if installed),
  1258. and ROS.
  1259.  
  1260.  
  1261.      <S>etup
  1262.  
  1263. This command starts ROSSETUP for the current mode, if logged in locally.
  1264. Remote operation of this command is not currently allowed.
  1265.  
  1266.      <X>pert mode toggle
  1267.  
  1268. In the sysop sub-system, pressing <X> will alternate between Expert and
  1269. Novice help levels, similar to the results normal users see when pressing
  1270. <X> at either the Files or Messages menu.
  1271.  
  1272.      <A>udit trail
  1273.  
  1274. This command allows you to create a standard ASCII text file from any system
  1275. output.  The audit trail file name is "ROS-AUDT.x" where "x" is the number
  1276. of the node.  If this file already exists, it will be appended to.  If it
  1277. does not, it will be created.
  1278.  
  1279.      <D>own at logout
  1280.  
  1281. This command is equivalent to pressing the <Alt-X> key from the local
  1282. console.  When the current user logs out, ROS will shutdown and return to
  1283. DOS.
  1284.  
  1285.      <F>iles
  1286.  
  1287. This command causes ROS to exit the sysop menu and enter the file menu.
  1288.  
  1289.      <M>essages
  1290.  
  1291. This command causes ROS to exit the sysop menu and enter the message menu.
  1292.  
  1293.      <G>oodbye (logout)
  1294.  
  1295. This command terminates the session.
  1296.  
  1297. Command Enhancements
  1298.  
  1299. Naturally, all the user commands are available to the sysop.  In addition,
  1300. several commands are enhanced when used by the sysop.
  1301.  
  1302.      Changing a Message Status or Message Area
  1303.  
  1304. After reading a message, the sysop will be given the option of altering the
  1305. message area or status of the message.  The options are as follow:
  1306.  
  1307.      <M>ove        move the message to another message area
  1308.      <I>ndividual  mark the message as private
  1309.      <O>pen        make the message an open letter, i.e. "Public"
  1310.      <D>elete      delete the message, even if not the sender or reciever
  1311.  
  1312. Note that all of these commands are available for any message that can be
  1313. displayed by the sysop, even one addressed to someone else.
  1314.  
  1315.      Setting the System Time and Date
  1316.  
  1317. After The <I>nfo <S>ystem command displays the PSTAT file, you will be given
  1318. the option of changing the current system time and date.
  1319.  
  1320.      User List Additions
  1321.  
  1322. When the user list is requested, ROS will allow the sysop to enter one of
  1323. four parameters:
  1324.  
  1325.      <A>ll          List all the fields in the user records.  The sysop may
  1326.                     select either <C>olumnar (fixed field length) or
  1327.                     <D>elimited (comma separated) format.  When captured
  1328.                     using the <A>dit command, the output from this command
  1329.                     is suitable for import into many database management
  1330.                     systems.  Two files, "ROSUSER.DB" and "ROSUSER.DBF" are
  1331.                     included for use with Paradox and dBaseIV respectively.
  1332.      <E>xceptional  List users with an access level or time limit greater
  1333.                     than that set for validated users.
  1334.      <U>nvalidated  List unvalidated, unregistered users.
  1335.      <Q>uick        List user names only (this is the same listing normal
  1336.                     users get).
  1337.  
  1338.  
  1339.  
  1340.  
  1341. EXTENDED DISPLAY CODES
  1342.  
  1343. When ROS is displaying text, it checks for an embedded ^B (control-B). If it
  1344. finds one, it replaces the number following with a value retrieved from the
  1345. system, at that time.  This means, for example, that you can include the
  1346. user's name and birthday right in their login screen.  Many values are
  1347. available (see the table below).  In addition, several codes are used to
  1348. control system operation.
  1349.  
  1350. The syntax of an Extended Display Code (EDC) is as follows:
  1351.  
  1352.      nnn["x"]
  1353.  
  1354. The smiley face above is a ^B.  The "nnn" indicates a three digit number
  1355. from 0-999 as described in the table below.  ["x"] indicates an optional
  1356. parameter that must be enclosed in quotation marks if included.
  1357.  
  1358. When used to define a numeric field, the following values may be entered:
  1359.  
  1360.      #    A digit position.  Unused digits are printed as blanks.
  1361.  
  1362.      *    A digit position.  Unused digits are printed as asterisks instead
  1363.           of blanks. Needs occur only once to activate this effect.
  1364.  
  1365.      @    A digit position.  Unused digits are printed as zeros instead of
  1366.           blanks. Needs occur only once to activate this effect.
  1367.  
  1368.      $    A digit position.  A floating dollar sign is returned in front of
  1369.           the number.  Needs occur only once to activate this effect.
  1370.  
  1371. Other characters (including commas and periods) will be inserted literally.
  1372. For example, the following are valid fields:
  1373.  
  1374.      "##,###,###"
  1375.      "*$###,###"
  1376.  
  1377. When used to define a time-of-day field, the following values may be
  1378. entered:
  1379.  
  1380.      h or H    Hours
  1381.      m or M    Minutes
  1382.      s or S    Seconds
  1383.      :         Colon character
  1384.      t         Displays "a" or "p"
  1385.      e         Displays "m"
  1386.  
  1387. Lowercase formatting characters cause numbers to be padded with "0".
  1388. Uppercase formatting characters cause numbers to be padded with spaces.  For
  1389. example, if the time of day is 1:15 in the afternoon, a mask of "Hh:mm te"
  1390. would produce " 1:15 pm".
  1391.  
  1392. A special case exists for date formatting.  If the parameter field is "1",
  1393. then displayed dates will be in the format "mm/dd/yy".  Otherwise, dates
  1394. will be displayed as "dd mmm yyyy".
  1395.  
  1396. A second special case exists for codes 4-6 where the parameter field is used
  1397. to specify the width of the string field for text justification.
  1398.  
  1399. See the accompanying .ASC and .ANS files for more examples.  The file
  1400. TEST.ASC activates all possible codes (though not all possible numeric
  1401. formats).  To use, append it to one of your menus such as MNUSYSOP.ASC and
  1402. use the menu display command (<?>) to bring it up or rename the file to a
  1403. bulletin, such as "BULLET.ASC" and select bulletin "ET" from the bulletin
  1404. menu.
  1405.  
  1406. Invalid EDC's will be ignored by ROS (and displayed to the user unchanged),
  1407. but future versions of ROS may use any numbers from 0-999.
  1408.  
  1409. While the message editor will not allow the entry of ^B characters, the
  1410. sysop can use the <L>oad command to send personalized messages to users that
  1411. contain EDC's.  See the accompanying .MSG files for examples.
  1412.  
  1413. NOTE: when using EDC's in files with ANSI sequences (.ANS), ensure the ^B is
  1414. not separated from the numeric code.  For example, in the file LOGOUT1.ANS,
  1415. the user's session duration (login time) is shown in a different color.  It
  1416. is imperative that this color change take place before the ^B, not between
  1417. the ^B and the EDC number.
  1418.  
  1419.      Miscellaneous System Controls
  1420.  
  1421.      000: Turn off break (^C) checking
  1422.      001: Turn off line count checking ("More..." prompts)
  1423.      002: Immediate "More..." prompt
  1424.      003: Delay for period specified in miliseconds (1000 = 1 second)
  1425.      004: Left justification - width specified in param
  1426.      005: Center justification - width specified in param
  1427.      006: Right justificiation - width specified in param
  1428.      007: Turn off justification
  1429.  
  1430.      System Values
  1431.  
  1432.      100: Current time and date
  1433.      101: Current version of ROS
  1434.  
  1435.      110: Node id
  1436.      111: System name
  1437.      112: Sysop name
  1438.      113: Max tries allowed for password
  1439.      114: Daily download count limit
  1440.      115: Daily download size limit
  1441.      116: Chat start time
  1442.      117: Chat end time
  1443.  
  1444.      120: System startup date/time
  1445.      121: Caller number
  1446.  
  1447.      User's Personal Information
  1448.  
  1449.      200: First name
  1450.      201: Last name
  1451.      202: Address
  1452.      203: City
  1453.      204: State
  1454.      205: ZIP
  1455.      206: Phone #1
  1456.      207: Phone #2
  1457.      208: Birthday
  1458.      209: User's system description
  1459.  
  1460.      User's Settings
  1461.  
  1462.      220: Message area
  1463.      221: File area
  1464.      222: Transfer protocol
  1465.      223: Columns
  1466.      224: Lines
  1467.      225: Color
  1468.  
  1469.      User's General Statistics
  1470.  
  1471.      240: Login date/time
  1472.      241: Time on
  1473.      242: Time left
  1474.      243: Times on
  1475.      244: Last login date/time
  1476.      245: Time allowed
  1477.      246: Total time used
  1478.      247: Extra time
  1479.      248: Last high message number
  1480.  
  1481.      User's File Transfer Stats
  1482.  
  1483.      260: Download count today
  1484.      261: Download size today
  1485.      262: Download count total
  1486.      263: Download size total
  1487.      264: Upload count today
  1488.      265: Upload size today
  1489.      266: Upload count total
  1490.      267: Upload size total
  1491.      268: Download count / Upload count
  1492.      269: Download size / Upload size
  1493.  
  1494.      User's Authorizations
  1495.  
  1496.      280: Access level
  1497.      281: Time limit
  1498.      282: Expiration date
  1499.  
  1500.      Messages Menu Values
  1501.  
  1502.      300: Messages in database
  1503.      301: Next message number
  1504.  
  1505.      Files Menu Values
  1506.  
  1507.      400: Files in database
  1508.  
  1509.  
  1510.  
  1511. WARNING AND ERROR MESSAGES
  1512.  
  1513. ROS has three categories of messages: "Warning," "Error," and  "Fatal
  1514. error."  The first two categories indicate situations or problems you should
  1515. be aware of but that have been handled by the system.  Fatal Errors are
  1516. those errors that are so severe that ROS cannot recover and has done its
  1517. best to close all open files and shutdown.  The following lists errors that
  1518. may be encountered:
  1519.  
  1520.      DOS errors
  1521.  
  1522.      0001:Invalid DOS function code
  1523.      0002:File not found
  1524.      0003:Path not found
  1525.      0004:Too many open files
  1526.      0005:Access denied
  1527.      0006:Invalid handle
  1528.      0008:Not enough memory
  1529.      0010:Invalid environment
  1530.      0011:Invalid format
  1531.      0012:Invalid file access code
  1532.      0015:Invalid drive
  1533.      0016:Cannot remove current directory
  1534.      0017:Cannot rename across drives
  1535.      0018:No more files
  1536.  
  1537.      I/O errors
  1538.  
  1539.      0100:Disk read error
  1540.      0101:Disk write error
  1541.      0102:File not assigned
  1542.      0103:File not open
  1543.      0104:File not open for input
  1544.      0105:File not open for output
  1545.      0106:Invalid numeric format
  1546.  
  1547.      Critical errors
  1548.  
  1549.      0150:Disk is write-protected
  1550.      0151:Unknown unit
  1551.      0152:Drive not ready
  1552.      0153:Unknown command
  1553.      0154:CRC error in data
  1554.      0155:Bad request structure length
  1555.      0156:Seek error
  1556.      0157:Unknown media type
  1557.      0158:Sector not found
  1558.      0159:Printer out of paper
  1559.      0160:Device write fault
  1560.      0161:Device read fault
  1561.      0162:Hardware failure
  1562.  
  1563.      Miscellaneous errors
  1564.  
  1565.      0200:Division by zero
  1566.      0201:Range check error
  1567.      0202:Stack overflow error
  1568.      0203:Heap overflow error
  1569.      0204:Invalid pointer operation
  1570.      0205:Floating point overflow
  1571.      0206:Floating point underflow
  1572.      0207:Invalid floating point operation
  1573.      0208:Overlay manager not installed
  1574.      0209:Overlay file read error
  1575.  
  1576.      Sort errors
  1577.  
  1578.      1103:Not enough memory available for sorting
  1579.      1108:Illegal item length
  1580.      1109:Too many records to sort
  1581.      1110:Write error during sort (disk full?)
  1582.      1111:Read error during sort
  1583.      1112:Could not create sort work file (directory full?)
  1584.  
  1585.      FOSSIL driver and modem errors
  1586.  
  1587.      2000:FOSSIL driver not found
  1588.      2001:FOSSIL version incompatible
  1589.      2100:Modem not responding
  1590.      2101:Modem returned an error
  1591.  
  1592.      File maintenance errors
  1593.  
  1594.      3000:Source area not found
  1595.      3001:Destination area not found
  1596.      3002:Source file not found
  1597.      3003:Destination file already exists
  1598.      3004:Could not create destination file
  1599.      3005:Could not delete source file
  1600.      3006:Could not update catalog
  1601.  
  1602.      System errors
  1603.  
  1604.      4000:System date not set
  1605.      4001:Invalid system name
  1606.  
  1607.      File access errors
  1608.  
  1609.      10500:Record modified by another user
  1610.                Note: this message may appear when editing a catalog record
  1611.                if the "Current area" is changed at the same time as another
  1612.                field in the record. To avoid this problem, edit only the
  1613.                "Current area" field during one pass.
  1614.      10501:Record deleted by another user
  1615.  
  1616.  
  1617.  
  1618. TECHNICAL SUPPORT
  1619.  
  1620. AIS maintains a 24 hour, multi-line, bulletin board (running ROS, of course)
  1621. as the best way to get answers to your questions.  Message and file areas
  1622. called "ROS" are available in which questions, comments, suggestions, and
  1623. problems concerning ROS will be found.  Public and private messages
  1624. addressed to "Sysop"  will be answered as quickly as possible.  Regular
  1625. updates to ROS will be found in the "ROS" file area.  The BBS number is
  1626. (505) 299-5974, 300-2400 bps, no parity, eight bit words, one stop bit
  1627. (N-8-1).  Technical support is also available through the mail at this
  1628. address:
  1629.  
  1630.      ROS Technical Support
  1631.      Associated Information Services
  1632.      P.O. Box 13711
  1633.      Albuquerque, NM  87112-3711
  1634.      USA
  1635.  
  1636. Your comments and suggestions are important and welcome.  Please use the
  1637. User Response Form to let us know what you think of ROS.
  1638.  
  1639.  
  1640.  
  1641. INDEX
  1642.  
  1643. address.........................31, 37
  1644. Albuquerque......................i, 37
  1645. ANSI.............................7, 30
  1646. answer................8, 9, 15, 20, 25
  1647. archive.............................22
  1648. areas.....................9, 20-22, 37
  1649. ASCII...........................24, 27
  1650. board........................1, 19, 37
  1651. bulletin.............1, 11, 19, 30, 37
  1652. change............5, 7, 20, 22, 23, 30
  1653. chat........................14, 15, 30
  1654. color........................7, 30, 31
  1655. comments............................37
  1656. connect..........................8, 17
  1657. connection...........................8
  1658. default.........................11, 20
  1659. deleted.................17, 22, 26, 35
  1660. directory....7, 10, 11, 13, 22, 33, 34
  1661. door............................10, 25
  1662. doors.............................1, 9
  1663. download.............11, 20, 22, 30-32
  1664. execute.............................24
  1665. goodbye.............................25
  1666. help..................3, 9, 14, 15, 27
  1667. license...........................3, 4
  1668. mail............................19, 37
  1669. newin...........................21, 22
  1670. others........................3, 8, 13
  1671. password.................5, 13, 24, 30
  1672. pause............................8, 25
  1673. pauses...............................8
  1674. program.............3, 4, 7, 9, 12, 21
  1675. prompt......13, 14, 19, 20, 23, 24, 30
  1676. prompts.............................30
  1677. protocol............................31
  1678. questions.......................25, 37
  1679. quit.................10, 19, 20, 22-25
  1680. read.................4, 19, 24, 33, 34
  1681. reading.............................27
  1682. ready....................9, 13, 21, 33
  1683. receive..............................4
  1684. refer............7, 10, 18, 19, 22, 24
  1685. registered....................4, 5, 23
  1686. related..............................3
  1687. release.....................19, 20, 22
  1688. remaining...........................14
  1689. remote.................1, 13-15, 24-26
  1690. replaces............................29
  1691. require...............3, 8, 10, 12, 24
  1692. respond...........................8, 9
  1693. responses.....................8, 9, 17
  1694. return........8-10, 14, 17, 24, 25, 27
  1695. returned........................29, 34
  1696. subsequent...................19-21, 23
  1697. toggle..............10, 14, 15, 19, 27
  1698. upload..................21, 22, 31, 32
  1699. wildcards...........................11
  1700.